---------------------------------------------------------------- NEDGauge OCX Control Copyright 1995-1997 Northeast Data Corp. All Rights Reserved ---------------------------------------------------------------- Release 1.2 June 1997 This document describes the NED Gauge Custom Control. CONTENTS 1. Product Description 2. Legal Information 3. Installation 4. Usage 5. Demonstration Application 6. Ordering Information 7. Support 8. Version release notes ---------------------------------------------------------------- 1. Product Description The NED Gauge OCX Control is a Microsoft Windows OLE custom control that presents a gauge control similar to those seen on the industrial process control equipment. This control is compatible with Windows '95. and Windows NT. Being a 32-bit OLE control, the programmer can add the NEDGauge Control into any 32-bit OCX container application, such as Visual C++, Visual Basic (32-bit), MS Access or Delphi. Use of the NED Gauge Control in a finished application requires the NED Gauge Control OCX (NGauge32.OCX) to be installed with the application. There are properties available that allow the programmer to control the behavior and appearance of the Control. The NEDGauge can appear in four different orientations. Colors of various parts of the control can be adjusted, and there are 3D properties that let you specify such things as borders and bevels. A High and Low limit can be set, which will cause an event to be sent to your application when either condition occurs. The range of the NEDGauge can be set to any range with low and high values varying from 0 to 32767. ------------------------------------------------------------------- 2. Legal Information The purchaser of the NEDGauge Control is allowed to use it and distribute it in applications without paying any royalty, and without printing or displaying a copyright notice for the control. This only includes distribution of the NED Gauge Control OCX (NGauge32.OCX). It does not include distribution of the NEDGauge.lic file, or the documentation that comes with the Control. The purchaser of the NEDGauge Control may distribute the control with applications that are networked (multiple users accessing the DLL from a file server) without paying any license fees to Northeast Data Corp. ------------------------------------------------------------------- 3. Installation Create a temp directory on your hard disk and copy all files from the distribution disk to the directory. These files include: NGauge32.OCX (NEDGauge OCX) README.TXT (this file) PROJECT1.VBP (Visual Basic 32-bit demo program) FORM1.FRM If you have downloaded the NGAGVB12.ZIP file, use PKUNZIP to extract the files into the temp directory. The files listed below are required to use the OCX and demo in this archive. This files can be found in OCX5032.ZIP in the same area as NGAGVB12.ZIP. This files in this archive should be placed in the same directory as the above OCX files. MFC42.DLL (Required for OCX) MSVCRT.DLL (Required for OCX) OLEPRO32.DLL (Required for OCX) OLEAUT32.DLL (Required for OCX) REGSVR32.EXE (Control registration utility) If you already have these files on your system, they are probably located in the System or System32 directory. If this is the case, you probably do not need to download these files again. To register the OCX, place all of the above files in the System(32) directory and run the REGSVR32 on the following files: MFC42.DLL OLEPRO32.DLL NGauge32.OCX From Visual Basic, open the PROJECT1.VBP file. If you have Microsoft Access, start it and create a form or report. From the Edit menu, choose Insert Object, and check the Custom Control radio button. Choose the NEDGauge control to insert it into the form or report. ------------------------------------------------------------------- 4. Usage PROPERTIES ---------- About... - Displays the about dialog box for the NEDGauge control. BackColor - Sets the background color. BorderColor - Color of the border. The border is the region between the outer and inner bevels. BorderWidth - Width of the border in pixels. FaceColor - Color of the dial area inside the gauge. HighAlarm - Gauge position value that will cause a high alarm event. HighAlarmColor - Color of the band on the gauge that represents high alarm values. HiliteColor - Color of the top and left sides of the inner and outer bevels if the bevel properties are set to "Raised" or "Solid". Color of the bottom and right sides if the bevel properties are set to "Inset". InnerBevel - Solid (2), Inset (0), or Raised (1). InnerBevelWidth - The width of the inner bevel in pixels. LowAlarm - Gauge position value that will cause a low alarm event. LowAlarmColor - Color of the band on the gauge that represents low alarm values. Max - Maximum NEDGauge value. This must be greater than the minimum NEDGauge value. Min - Minimum NEDGauge value. This must be less than the maximum NEDGauge value. NeedleColor - Color of the needle. NormalColor - Color of the arc between the high and low alarm regions. Orientation - Bottom(0), Left(1), Right(2), Top(3) OuterBevel - Solid (2), Inset (0), or Raised (1). OuterBevelWidth - The width of the outer bevel in pixels. Pos - Current NEDGauge position. This must be a value between or including the current minimum and maximum values of the NEDGauge. ShadowColor - Black (0), Gray (1). The color of the left and top sides of the outer and inner bevels when the bevel styles are "Inset". The color of the bottom and right sides when the style is set to "Raised". EVENTS ------ Alarm The Alarm parameter is: 1 - Low alarm 2 - High alarm ----------------------------------------------------------------------- 5. Demonstration Application The VB demo app displays a single NED Gauge Control. The gauge range is set 0-100. A standard scrollbar control is used to adjust the position of the gauge needle. The Alarm event is handled by displaying a messagebox whenever an alarm occurs. ------------------------------------------------------------------------ 6. Ordering Information The price of the 32-bit NED Gauge control is $89.00US. The price of the 16-bit NED Gauge control is $45.00US. The price of the NED Gauge Control Source is $230.00US. Physical shipping and handling fees in the US are $15.00US. Physical shipping and handling fees outside the US are $20.00US. ***E-mail delivery is free.*** New York State residents must add 8% sales tax. DIRECT For US orders, we accept Visa, MasterCard, Purchase Orders, check or money order. For orders outside of the US, we accept Visa or MasterCard. For credit card orders, you may call or fax us at (716) 426-7334. Please specify the following information: Product you wish to order Quantity (one per developer per product) Credit Card Type (Visa or MasterCard) Name on Credit Card Expiration Date Name and address of person the software is registered to. Phone and fax numbers e-mail address Please specify e-mail or physical delivery methods. ***E-mail delivery is free.*** COMPUSERVE The ID for the 32-bit NED Gauge control is 9283. The ID for the 16-bit NED Gauge control is 9280. RESELLERS at-Once Software (www.atonce.com) US sales only ObjectTiger (www.objecttiger.com) US and International Sales ------------------------------------------------------------------------ 7. Support Technical support is available only for registered users. Northeast Data Corp. 2117 Buffalo Rd., Suite 290 Rochester, NY 14624 Phone (716) 426-7334 (voice & fax) E-Mail: ned1@frontiernet.net CompuServe: 71321,3304 Home Page: http://www.frontiernet.net/~ned1/index.htm ------------------------------------------------------------------------ 8. Version Release Notes Version 1.0 - December 1995 First release. Version 1.1 - January 1996 Fixed problem with demo dialog crashing the control. Version 1.2 - June 1997 Rebuilt with VC++ 5.0 - smaller file size.